package com.example.store.mapper;


import com.example.store.entity.User;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.Date;

/**
 * 用户模块的持久层接口
 */
@Mapper
public interface UserMapper {
    /**
     * 插入用户的数据
     * @param user 用户的数据
     * @return 首受影响的行数（增、删、查，都受影响的行数作为返回值,可以根据返回值来判断是否执行成功）
     */
    Integer insert(User user);

    /**
     * 根据用户名查询用户数据
     * @param username 用户名
     * @return 如果找到对应的数据，返回该用户，否则return null;
     */
    User findByUsername(String username);

    /**
     * 根据用户的uid来修改用户密码
     * @param uid 用户的id
     * @param password 用户输入的新密码
     * @param modifiedUser 表示修改的执行者
     * @param modifiedTime 表示修改的时间
     * @return 返回值为受到影响的行数
     */
    // @Param 用注解来命名参数
    // @Param("SQL映射文件中#{}占位符的变量名") 解决的问题：当SQL语句的占位符和映射接口方法参数名不一致时，
    // 需要将某个参数强行注入到某个占位符变量上时，可以用@param这个注解来标注映射的关系
    Integer updatePasswordByUid(
            @Param("uid") Integer uid,
            @Param("password") String password,
            @Param("modifiedUser") String modifiedUser,
            @Param("modifiedTime") Date modifiedTime
    );

    /**
     * 根据用户的id查询用户的数据
     * @param uid 用户的id
     * @return 如果找到返回对象，反之返回null
     */
    User findByUid(@Param("uid") Integer uid);


    /**
     * 根据用户uid来修改用户的头像
     * @param uid
     * @param avatar
     * @param modifiedUser
     * @param modifiedTime
     * @return
     */
    Integer updateAvatarByUid(
            @Param("uid") Integer uid,
            @Param("avatar") String avatar,
            @Param("modifiedUser") String modifiedUser,
            @Param("modifiedTime") Date modifiedTime
    );

    /**
     * 跟新用户数据
     * @param  user  用户的数据
     * @return 返回值为受影响的行数
     */
    Integer updateInfoByUid(User user);
}
